AOOli 


NAVAL  POSTGRADUATE  SCHOOL 

Monterey,  California 


THESIS 


PRINTER  MULTIPLEXING 
AMONG 
MULTIPLE  Z-100  MICROCOMPUTERS 


by 
Kwang  Jun  Choi  and  Ju  Kab  Lee 
December  1985 


Thesis  Advisor 


Uno  R.  Kodres 


Approved  for  public  release;  distribution  is  unlimited 


T2260!56 


CURirv  CLASSIFICATION  OF  THIS  PAGE 


REPORT  DOCUMENTATION  PAGE 


1.  REPORT  SECURITY  CLASSIFICATION 

JNCLASSIFIED 


lb.  RESTRICTIVE   MARKINGS 


J.  SECURITY  CLASSIFICATION  AUTHORITY 


3.  DECLASSIFICATION /DOWNGRADING  SCHEDULE 


3     DISTRIBUTION /AVAILABILITY  OF  REPORT 

Approved  for  public  release; 
distribution  is  unlimited 


PERFORMING  ORGANIZATION  REPORT  NUMB£R(S) 


S.  MONITORING  ORGANIZATION  REPORT  NUMBER(S) 


a.  NAME  OF  PERFORMING  ORGANIZATION 

•laval   Postgraduate    School 


6b    OFFICE  SYMBOL 
(If  applicable) 

52 


7a.  NAME  OF  MONITORING  ORGANIZATION 

Naval   Postgraduate   School 


c.  ADDRESS  {City,  State,  and  ZIP  Code) 


Monterey,    CA        93943-5100 


7b.   ADDRESS  (C/ty,  State,  and  ZIP  Code) 


Monterey,    CA        93943-5100 


a.  NAME  OF  FUNDING/SPONSORING 
ORGANIZATION 


8b.  OFFICE  SYMBOL 
(If  applicable) 


9,  PROCUREMENT  INSTRUMENT  IDENTIFICATION  NUMBER 


c.  ADDRESS  (C/fy,  State,  and  ZIP  Code) 


10    SOURCE  OF  FUNDING  NUMBERS 


PROGRAM 
ELEMENT  NO 


PROJECT 
NO 


TASK 
NO 


WORK  UNIT 
ACCESSION   NO 


1     TITLE  (Include  Security  Clasiification) 

PRINTER  MULTIPLEXING  AMONG  MULTIPLE  Z-100  MICROCOMPUTERS  (UNCLASSIFIED) 


2  PERSONAL  AUTHOR(S) 

Choi,  Kwang  Jun  and  Lee,  Ju  Kab 


3a  TYPE  OF  REPORT 

Master' s  Thesis 


13b    TIME  COVERED 
FROM  TO 


14    DATE  OF  REPORT   (Year,  Month,  Day) 

1985    T)ec.e.mhe.r 


15    PAGE  COUNT 


2£. 


6    SUPPLEMENTARY  NOTATION 


COSATI  CODES 


FIELD 


GROUP 


SUB-GROUP 


18    SUBJECT  TERMS  {Continue  on  reverse  if  necessary  and  identify  by  block  number) 

Concentrator,  Single  Board  Connuter,  Z-100,  CP/M- 
85,  CP/M-86,  I/O  Expansion  Board,  BOOT  Process, 
CONTROL  Process,  SPOOL  Process.  Download 


9    ABSTRACT  {Continue  on  reverse  if  necessary  and  Identify  by  block  numtter) 

This  thesis  describes  the  detailed  design  an 
printer  server  in  the  laboratory  environment 
among  multiple  Zenith  Z-100  microcomputers, 
is  a  controller  box  which  consists  of  a  nowe 
computer,  and  the  BLC  8538  eight  channel  I/O 
Z-100  microcomputer  is  connected  to  the  cont 
port. 

The  Printer  Server  System  has  three  software 
and  SPOOL.  The  BOOT  process,  resident  in  th 
the  CONTROL  file  from  any  one  of  multiple  Z- 
The  CONTROL  process  allows  the  printer  to  be 
multiple  Z-lOO's  at  a  time.  The  SPOOL  proce 
the  CONTROL  process  to  the  printer  or  saves 


d  implementation  of  a 
of  sharing  resources 
The  Printer  Server  System 

r  supply,  a  sinrle  board 
expansion  boards.   Each 

roller  thru  V.\q    "^8-2  320 

utilities:   BOOT,  CONTROL 
e  controller,  downloac's 
100 's  which  is  turned  on. 

used  by  any  one  o:^ 
ss  sends  the  data  thru 
the  data  on  the  (Continue! 


20    DISTRIBUTION /AVAILABILITY  OF  ABSTRACT 

£1  UNCLASSIFIED/UNLIMITED       D  SAME  AS  RPT  Q  OTIC   USERS 


21    ABSTRACT  SECURITY  CLASSIFICATION 

r^TLASSIFIFD 


22a    NAME  OF  RESPONSIBLE  INDIVIDUAL 

Prof.    Uno    R.    Kodres 


22b  TELEPHONE  (Include  Area  Code) 

(^lO"])     626-219  7 


22c    OFFICE   SYMBOL 


DD  FORM  1473, 84  MAR 


83  APR  edition  may  be  used  until  exhausted 
All  other  editions  are  obsolete 
1 


SECURITY  CLASSIFICATION  OF  THIS  PAGE 


SECURITY  CLASSIFICATION  OF  THIS  PAGE  (Whmn  Dmtm  Bntmnd) 


19.       ABSTRACT    (Continued) 
disk   file. 


S-  N  0102-  LF-  014-  6601 


SECURITY  CLASSIFICATION  OF  THIS  PAGE(Tm«n  Dmtm  Bnfrmd) 


Approved  for  public  release;  distribution  is  unlimited, 


Printer  Multiplexing 
among 
Multiple  Z-100  Microcomputers 


by 


Choi,  Kwang  Jun 
Captain,  Korea  Army 
B.S.,  Korea  Military  Academy,  1978 

and 

Lee ,   Ju     Kab 
Captain,  Korea   Army 
B.S.,  Korea  Military  Academy,  1979 


Submitted  in  partial  fulfillment  of  the 
requirements  for  the  degree  of 


MASTER  OF  SCIENCE  IN  COMPUTER  SCIENCE 


from  the 


NAVAL   POSTGRADUATE    SCHOOL 


December    1.9j85 


ABSTRACT 


This  thesis  describes  the  detailed  design  and  implemen- 
tation of  a  printer  server  in  the  laboratory  environment  of 
sharing  resources  among  multiple  Zenith  Z-100  microcom- 
puters. The  Printer  Server  System  is  a  controller  box  which 
consists  of  a  power  supply,  a  single  board  computer,  and  the 
BLC  8538  eight  channel  I/O  expansion  boards.  Each  Z-100 
microcomputer  is  connected  to  the  controller  thru  the 
RS-232C  port. 

The  Printer  Server  System  has  three  software  utilities: 
BOOT,  CONTROL  and  SPOOL.  The  BOOT  process,  resident  in  the 
controller,  downloads  the  CONTROL  file  from  any  one  of 
multiple  Z-100*s  which  is  turned  on.  The  CONTROL  process 
allows  the  printer  to  be  used  by  any  one  of  multiple  Z-lOO's 
at  a  time.  The  SPOOL  process  sends  the  data  thru  the 
CONTROL  process  to  the  printer  or  saves  the  data  on  the  disk 
file. 
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I.  INTRODUCTION 

A.   GENERAL  DISCUSSION 

In  a  school  or  many  companies,  several  personal 
computers  are  used  on  the  same  floor  or  the  same  room. 
Instead  of  having  a  printer  with  each  personal  computer,  it 
is  economical  to  share  a  high  quality  printer  among  many 
users.  More  generally,  it  is  economical  to  share  other  high 
cost  resources  such  as  laser  printers,  Ethernet  local  area 
network  controllers,  high  capacity  disc  units,  among  the 
personal  computer  users.  It  is  the  motivation  to  share 
expensive  resources  that  has  given  rise  to  this  thesis. 

To  design  and  implement  a  system  which  permits  the 
sharing  of  a  printer  among  twenty-three  users,  each  user 
making  use  of  a  Zenith  Z-100  personal  computer,  the  hardware 
system,  known  as  the  Concentrator,  consists  of  a  MULTIBUS 
based  backplane  with  an  independent  power  supply,  an  INTEL 
iSBC  86/12A  single  board  computer,  three  National 
Semiconductor  BLC  8538  serial  I/O  expansion  boards,  all 
enclosed  in  a  cardcage.  The  Zenith  Z-100  personal  computers 
are  connected  via  their  teletype  ports (RS232  compatible)  to 
the  I/O  ports  of  the  Concentrator. 

The  software  system  consists  of  the  Control 
Program, which  is  down- loaded  from  a  Z-100  at  power-up  of  the 
Concentrator  and  any  Z-100  system,  and  which  thereafter 
executes  in  the  Concentrator  permitting  the  shared  use  of 
the  printer  on  a  first-come  first-serve  basis. 

The  remaining  software  is  a  utility  program,  called 
SPOOL,  which  operates  in  the  CP/M  environment  on  the  Z-100 
and  permits  the  user  to  store  his  interactive  printer  data 
on  his  disc  unit,  while  the  printer  is  busy  printing  another 
user's  files. 

The  Control  Program  in  the  concentrator  is  implemented 
in  assembly   language.    The   CP/M  operating   system  in   the 
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Z-100  is  modified  by  modifying  the  Basic  Input/Output  System 
(BIOS)  of  CP/M-85  for  use  for  communication  with  the 
Concentrator. 

The  SPOOL  program,  also  written  in  assembly  code,  allows 
the  users  to  share  the  high  speed  printer  in  a  batch  mode, 
that  is,  each  user  prints  out  the  files  he  desires,  while 
any  other  user  who  wishes  to  make  interactive  use  of  the 
printer  at  the  same  time  can  save  the  information  in  his 
disk  file  for  later  batch  printing.  This  permits  an  econom- 
ical usage  of  a  high  cost  resource  without  the  inconvenience 
of  long  waits  due  to  interactive  use  of  the  printer. 

B.   FORMAT  OF  THESIS 

Chapter  I  gives  an  overview  of  this  thesis.  It  also 
provides  the  general  concepts  and  the  construction  of  our 
system  and  explains  why  this  thesis  has  practical  value. 

Chapter  II  explains  the  hardware  basis  of  the  system. 
Detailed  information  is  given  about  all  major  hardware 
components  which  are  used  to  construct  the  printer  sharing 
system  which  is  implemented  in  this  thesis. 

Chapter  III  describes  the  general  structure  of  the  CP/M 
operating  system.  The  standard  CP/M-85  operating  system  is 
discussed  in  moderate  detail.  Also  covered  is  the  modifica- 
tion of  the  CP/M-85  necessary  to  carry  out  the  project. 

Chapter  IV  explains  the  role  and  the  structure  of  the 
Concentrator.  Three  utility  programs,  BOOT,  CONTROL,  and 
SPOOL,  are  explained  in  detail. 

Chapter  V  summarizes  the  advantage  of  this  system  and 
indicates  a  direction  for  future  research  for  microcomputer 
communication  and  networking  using  the  local  area  network, 
Ethernet . 
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II.  HARDWARE  BASIS  OF  THE  SYSTEM 

As  stated  in  the  introduction,  the  most  important  hard- 
ware components  of  this  system  are  the  iSBC  86/12A  single 
board  computer,  the  I/O  expansion  board,  the  multiple  Z-100 
microcomputers  and  the  printer.  Figure  2.1  depicts  the 
interconnection  of  these  components  as  they  exist  at  this 
time.  In  the  paragraphs  which  follow,  a  description  of  each 
component  and  its  role  in  the  overall  system,  is  explained. 
A  detailed  description  of  each  component  can  be  found  in  the 
cited  references. 

A.   ISBC  86/12A  SINGLE  BOARD  COMPUTER 
1.   General  Description 

The  iSBC  86/12A  single  board  computer,  which  is  a 
member  of  Intel's  complete  line  of  8-bit  and  16-bit  single 
board  computer  products,  is  a  complete  computer  system  on  a 
single  printed-circuit  assembly.  This  board  includes  a 
16-bit  Central  Processing  Unit (CPU),  up  to  32K  bytes  of 
Erasable  Programmable  Read  Only  Memory (EPROM) ,  64K  bytes  of 
Random  Access  Memory  (RAM) ,  a  serial  communications  inter- 
face, three  programmable  parallel  I/O  ports,  programmable 
timers,  priority  interrupt  control,  MULTIBUS  interrupt 
control  logic,  and  bus  expansion  drivers  for  interfaces  with 
other  MULTIBUS  interface-compatible  expansion  boards.  The 
systems  view,  however,  is  an  abstract  model,  as  systems 
exist  only  in  the  mind  of  the  analyst.   [Ref.  4:  1.1  -  1.3]. 
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CONCENTRATOR 


Multibus 


iSBC  86/12A 


(=4 


Expansion 
Board 
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Figure  2.1    System  Configuration. 

2 .   Memory 

The  iSBC  86/12A  board  includes  64K  bytes  of  read/ 
write  memory  composed  of  sixteen  2117  Dynamic  RAM  chips  and 
an  8202  RAM  controller. 

Four  IC  sockets  are  provided  for  user  installation 
of  EPROM  chips,  and  jumpers  are  provided  to  accommodate 
either  2K,  4K,  or  8K  chips.  The  EPROM  address  space  is 
located  at  the  top  of  the  1-megabyte  memory  space  because 
the  8086  CPU  branches  to  FFFFO  after  a  reset. 

This  single  board  computer  is  used  as  the  controller 
in  the  system.  The  control  process  of  the  Concentrator  is 
loaded   into  the   memory  of   this  iSBC   86/12A  single   board 
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computer  at  the  time  of  initialization  of  the  system.  The 
control  process  communicates  to  the  multiple  Z-lOO's  and  the 
printer,  and  receives  or  sends  data  from  or  to  the  devices. 
For  the  detail  of  the  memory  organization,  see  [Ref.  4:  pp 
4.2  -  4.3]. 

B.   INTEL  8086 

The  Intel  8086  is  a  high  performance,  general  purpose 
16-bit  microprocessor.  The  8086  is  a  full  16-bit  processor 
with  respect  to  both  its  internal  structure,  and  its 
external  connections.  Refer  to  Figure  2.2  for  a  general 
overview  of  its  internal  structure  and  organization.  This 
section  is  intended  to  give  general  knowledge  about  this 
device.   A  detailed  description  can  be  found  in  [Ref.  3]. 

1.  Major  Features  of  the  8086 

In  this  section,  we  shall  discuss  the  major  features 
of  the  8086  CPU  chip.  The  8086  has  a  20-bit-wide  address 
bus,  providing  it  with  the  capability  of  addressing  a  full 
megabyte  of  memory.  However,  the  address  registers  of  the 
8086  chip  are  only  sixteen  bits  wide.  This  is  equivalent  to 
only  sixty  four  kilobytes.  This  processor  uses  a  method 
called  segmentation  to  allow  smooth  access  to  the  whole 
megabyte  of  address  space.  The  twenty  bit  physical  address 
is  formed,  by  adding  a  sixteen  bit  offset  to  a  twenty  bit 
address  whose  most  significant  sixteen  bits  come  from  a 
sixteen  bit  segment  register. 

2 .  Registers 

The  8086  contains  fourteen  16-bit  registers.  Some 
of  these  belong  to  the  EU(Execution  Unit)  and  others  belong 
to  the  BIU(Bus  Interface  Unit).  The  EU  registers  tend  to  be 
general-purpose  registers,  whereas  the  BIU  registers  tend  to 
be  used  for  addressing.  There  are  eight  16-bit  general 
purpose  registers.  Four  of  these  are  byte  or  word  addres- 
sable and  are  referred  to  as  the  'data  group'.  The 
remaining  four  are  only  word  addressable  and  are  referred  to 
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Figure  2.2    Functional  Structure  of  8086. 

as  the  pointer  and  index  register,  SP,  BP,  SI,  and  DI ,  which 
cannot  be  further  subdivided. 

SP  is  the  stack  pointer,  BP  is  the  base  pointer  and 
SI  and  DI  are  named  the  source  and  destination  index 
register,  respectively. 
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The  flags  register  is  sixteen  bits  wide  and  consists 
of  nine  usable  status  bits  for  the  processor.  These  include 
:  zero  flag(ZF),  direction  flag(DF),  interrupt  flag(IF), 
overflow  flag(OF),  and  trap  flag(TF). 

The  BIU  has  the  remaining  registers  :  four  segment 
register,  CS,  DS,  SS,  and  ES .  These  stand  for  the  code, 
data,  stack,  and  extra  segment  register  respectively,  and 
one  instruction  pointer(IP). 

C.   COMMUNICATION  EXPANSION  BOARD 

This  expansion  board  is  used  to  connect  the  multiple 
Z-100  computers  and  the  printer  to  the  single  board  computer 
of  the  Concentrator.  We  can  connect  from  fifteen  to  twenty 
three  Z-100  microcomputers  with  two  or  three  BLC  8538  eight 
channel  communication  expansion  boards.  The  BLC  8538  eight 
channel  communication  expansion  board  provides  fully 
programmable  synchronous  of  asynchronous  serial  communica- 
tion channels  with  RS232C  interfaces  to  expand  system  serial 
communications  capability.  Each  individual  channel  provides 
two  interrupt  requests  with  distinct  priorities.  The  BLC 
8538  is  compatible  with  all  National  Semiconductor  Serial  80 
cardcages,  back  planes  and  microcomputer  system  bus 
structures . 

The  universal  synchronous  and  asynchronous  receiver/ 
transmitter(USART)  control  logic  block  gates  the  data  on  the 
data  bus  to  the  appropriate  USART  reset  pins.  Writing  to 
the  USART  reset  logic  register  resets  each  USART  displaying 
a  logic  one  on  its  corresponding  data  line.  Two  74LS08  and 
gate  devices  gate  the  data  bus  to  the  appropriate  USART 
reset  pins.  Data  lines  zero  thru  seven(DA0-DA7 )  are 
logically  ANDed  with  the  reset  I/O  line.  Writing  to  the 
reset  register  causes  each  set  data  bit  in  the  USART  control 
logic  to  reset  its  corresponding  USART. 
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A  USART  reset  causes  the  following  : 

a)  Resets  status  bits  to  zero, 

b)  Disables  the  transmitter  and  receivers, 

c)  Clears  any  interrupt  requests, 

d)  Clears  the  mode,  status  and  command  registers. 

The  USART 's  function  is  to  transmit  eight  (or  less)  bits 
of  data  on  one  signal  wire  in  a  serial  fashion  to  another 
USART.  The  other  USART  assembles  the  serial  bit  pattern 
into  an  eight  bit  value  transf errable  to  the  data  lines  of  a 
data  bus  of  a  computer.  Each  USART  uses  four  address  loca- 
tions :  one  as  a  data  register,  one  as  a  control  register, 
one  as  mode  selection  register,  and  one  as  a  status 
register.  The  2651  has  nine  8-bit  registers  that  can  be 
written  to  and/or  read  from  by  the  system  CPU  through  the 
data  bus  D7-D0.  The  nine  8-bit  registers  are  mode  register 
1,  mode  register  2,  command  register,  status  register, 
SYN1/SYN2/DLE  registers,  and  transmit/receive  data  holding 
registers. 

The  2651  USARTs  must  be  programmed  by  the  system  CPU 
before  transmitting  or  receiving  data.  Programming  the  USART 
consists  of  four  steps.  First,  the  user  should  reset  the 
USART.  Second,  the  user  writes  to  the  Mode  Register  1.  On 
the  third  step,  the  user  writes  to  the  Mode  Register  2. 
Finally,  the  user  writes  to  the  Command  Register. 
The  registers  are  described  in  detail  below. 

1.   Mode  Register  1 

This  register  sets  the  mode (synchronous  or  asynchro- 
nous), parity  use  and  type,  character  length,  and  other 
parameters.  The  register  format  is  shown  in  Figure  2.3.  In 
our  program,  the  programming  code  will  be  OlOOlllOB (4EH) . 
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2.      Mode   Register   2 

This  register  sets  the  baud  rate  and  the  external/ 
internal  characteristic  of  the  transmitter  and  receiver 
clocks.  The  register  format  is  shovm  in  Figure  2.4.  The 
programming    code   will   be   00111110B(3EH) . 
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10=m   stop   bits 
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*baud  rate  factor  in  asynchronous  mode 
applies  only  if  external  clock  is  se- 
lected. Factor  is  16x  if  internal  cl- 
ock  is    selected. 


Figure    2.3        Mode   Register    1   Format. 


3 .       Command   Register 

This  register  controls  the  DTR  (Data  Terminal  Ready) 
and  RTS  (Request  to  Send  Data)  outputs,  operating  mode, 
transmit  control  enable  and  receive  control  enable.  The 
register      format    is      shown      in      Figure    2.5.  The        command 

register      can     be      written      to,         but      not      read      from.      The 
programming    code   will   be    00000111B(07H) . 
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MR2-7 

MR2-6 

MR2-5 
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tter     clock 
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baud  rate   selection 

0001=75  baud 
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0110=600  baud   0111=1200  baud 


Figure  2.4   Mode  Register  2  Format. 

4.  Status  Register 

The  status  register  indicates  the  state  of  the  TxRDY 
(Transmitter  Ready  Interrupt)  and  RxRDY  (Receiver  Ready 
Interrupt)  outputs  and  the  DCD  (Data  Carrier)  and  DSR  (Data 
Set  Ready)  inputs.  The  register  format  is  shown  in  Figure 
2.6.  The  status  register  can  be  read  from,  but  not  written 
to.  If  the  Transmitter  is  ready,  the  code  will  be 
OOOOOOOIB(OIH) .  If  the  Receiver  is  ready,  the  code  will  be 
00000010B(02H). 

5.  SYN1/SYN2/DLE  Registers 

If  synchronous  operation  is  chosen,  these  three 
registers  must  be  loaded  to  provide  characters  for  synchron- 
ization, idle,  fill,  and  data  transparency.  The  use  of  these 
characters  is  governed  by  the  mode  into  which  the  USART  is 
programmed.  For  example,  bits  6  and  7  of  Mode  Register  1 
control  the  number  of  SYN  characters  used  and  the  transpar- 
ency mode.  These  registers  are  not  used  in  this 
application. 
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6.      Transmit /Receive   Data  Holding  Registers 

These  two  registers  share  the  same  address.  When 
transmitting,  the  system  CPU  writes  a  data  word  to  the 
Transmit  Data  Holding  Register  so  that  it  can  be  serialized 
and  transmitted.  When  receiving,  the  system  CPU  reads  from 
the  Receive  Data  Holding  Register  to  receive  the  data  word 
that   has      been   received      and   deserialized.  The   detail      of 

USART    can  be    found   in    [Ref.    10:    pp.    3.7    -    3.16], 
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Figure    2.5        Command   Register   Format. 
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Figure    2.6        Status   Register  Format. 
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III.  SYSTEM  SOFTWARE 

An  operating  system  is  any  program  or  group  of  related 
programs  whose  purpose  is  to  act  as  an  intermediary  between 
the  hardware  and  the  user  of  a  computer.  In  the  case  of  a 
small  microcomputer  application,  the  operating  system  may 
consist  of  little  more  than  a  set  of  service  routines  and  a 
simple  set  of  commands  that  allows  the  user  to  load  or  dump 
memory  to  or  from  an  external  storage  device,  to  modify 
bytes,  and  to  test  application  programs. 

A  more  sophisticated  operating  system  may  have  a  disk- 
controller  interface  and  some  form  of  memory  management.  The 
highest  level  of  operating  system  includes  such  features  as 
multiprogramming,  bank-selected  memory,  a  hard-disk 
controller  interface,  and  random  track-sector  allocation. 
CP/M  (Control  Program  for  Microcomputers)  is  typical  of  a 
class  of  operating  systems  for  the  microcomputers  currently 
in  widespread  use. 

This  chapter  describes  the  structure  of  CP/M-85  oper- 
ating system  for  the  Z-100  microcomputers  and  some 
modifications  to  it. 

A.   CP/M-85  OPERATING  SYSTEM 

1.   General  Discussion 

CP/M-85  operating  system  for  the  Z-100  microcomputer 
is  divided  into  two  software  components:  the  "system  kernel" 
and  the  "BIOS  files". 

The  system  kernel  is  a  set  of  programs  that  reside 
on  the  reserved  system  tracks  of  a  disk.  Special  data 
transfer  utilities  (usually  SYSGEN  and/or  MVCPM207)  are  used 
to  copy  the  system  kernel  from  one  disk  to  another.  The 
system  kernel   manages  files,    translates  the   commands  you 
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enter  at  the  keyboard,   and  performs  other  functions  that  do 
not  depend  upon  specific  hardware  characteristics. 

CP/M-85  BIOS  consists  of  two  files,  BIOS85.SYS  and 
BI0S88.SYS,  which  reside  on  the  file  tracks  of  the  disk. 
The  portion  of  the  BIOS  stored  in  the  file  BIOS85.SYS  uses 
the  8085  processor  of  the  Z-100.  The  portion  stored  in 
BIOS88.SYS  uses  the  8088  processor  of  the  Z-100.  For 
further  information  on  the  CP/M-85,  refer  to  [Ref.  7:  pp 
1.9  -  1.10]. 

2 .   Structure 

CP/M  is  logically  divided  into  four  parts,  called 
the  Basic  I/O  System  (BIOS),  the  Basic  Disk  Operating  System 
(BDOS),  the  Console  Command  Processor  (CCP),  and  the 
Transient  Program  Area  (TPA) .  The  memory  organization  of 
the  CP/M  system  is  in  the  Figure  3.1. 

a.   Basic  Disk  Operating  System  (BDOS) 

The  BDOS  is  responsible  for  all  management 
functions  including  disk- file  management,  I/O  high-level 
management,  and  all  other  function  calls  available  to  the 
user.  The  BDOS  makes  calls  to  the  BIOS,  which  interfaces 
with  the  actual  hardware  environment  of  the  microcomputer. 
For  the  detail  of  the  BDOS  functions , see  [Ref.  12:  p.  140]. 
and  [Ref.  8:  pp.  124  -  125]. 

Our  SPOOL  program  will  use  some  of  the  BDOS 
functions :List  Output,  Make  File,  Write  File,  Close  File, 
and  so  on.  The  List  Output  function  is  activated  by  pressing 
Control-P  key,  which  copies  everything  that  appears  on  the 
screen  to  the  printer. 

Access  to  a  file  on  the  disk  is  done  through  an 
File  Control  Block  (FCB).  An  FCB  is  supplied  for  each  file 
the  user  wishes  to  access.  The  detailed  description  of  FCB 
is  found  in  [Ref.  8:  pp.  93  -  94]. 
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b.  Basic  I/O  System  (BIOS) 

The  BIOS  is  a  hardware -dependent  module  that 
defines  the  exact  low  level  interface  with  a  particular 
computer  system  that  is  necessary  for  peripheral  device  I/O. 
The  BIOS  is  a  collection  of  user-written  subroutines  for 
primitive  character  I/O  and  disk  access.  Disk  functions 
include:  set  DMA  address,  set  track  and  sector,  read  sector, 
write  sector  and  so  on.  A  series  of  jump  vectors  is  located 
at  the  head  of  the  BIOS  and  points  to  all  internal  subrou- 
tines. The  BDOS  locates  subroutines  in  the  BIOS  by  calling 
the  subroutines  at  the  known  location  in  the  jump  vector 
area. 

c.  Console  Command  Processor  (CCP) 

When  CP/M  becomes  active,  it  gives  control  to 
the  CCP,  which,  is  actually  an  application  program  loaded  at 
the  top  of  the  TPA.  When  first  entered,  the  CCP  displays  a 
prompt  character,  'A>'.  This  indicates  which  disk  drive  is 
currently  logged  in  for  use.  To  change  drives,  the  user 
simply  enters  the  drive  name  and  a  colon  (for  example,  B:). 
This  causes  the  CCP  to  request  the  BDOS  function  call 
"select  disk,"  with  register  E  containing  a  number  repre- 
senting the  requested  drive  (A=l,  B=2,  and  so  forth).  There 
are  five  built-in  commands:  TYPE,  DIR,  REN,  ERA,  and  SAVE.  A 
number  of  transient  commands  are  also  provided:  SYSGEN, 
PIP,  ED,  ASM,  DUMP,  LOAD,  STAT,  MOVCPM,  SUBMIT,  and  DDT. 
These  commands  are  actually  .COM  files  or  memory  image 
files.  For  the  detail  of  the  CCP  operation,  see  [Ref.  12: 
pp.  148  -  149]  . 
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d.   Transient  Program  Area  (TPA) 

The  TPA  is  an  area  of  memory  (i.e.,  the  portion 
that  is  not  used  by  the  FDOS  and  CCP)  where  various  nonresi- 
dent operating  system  commands  and  user  programs  are 
executed.  The  lower  portion  of  memory  is  reserved  for 
system  information.  For  the  detail  about  the  memory  organi- 
zation, see  [Ref.  8:  pp  89  -  90  ]. 
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Figure  3.1   Memory  Organization  of  CP/M. 


25 


B.   MODIFICATION  TO  CP/M-85  BIOS 

Since  the  SPOOL  utility  program  uses  the  List  Output 
function  as  described  in  the  previous  section,  we  should 
intercept  some  point  of  the  List  Output  function  routine  in 
BIOS.  The  BIOS85.SYS  file  could  be  modified  by  using  the 
DDT  debugging  utility. 

The  BIOS  entry  point  of  List  Output  function  is  located 
at  F93DH.  This  is  shown  in  the  Figure  3.2  a.  We  patch  this 
point  so  that  the  List  Output  function  pass  through  a 
certain  intercept  program  in  the  TPA  area  to  the  BIOS.  It's 
necessary  to  place  the  intercept  routine  at  an  area  of  the 
TPA  that  is  near  to  the  BIOS.  Since  the  BIOS  starts  from 
D900H,  we  place  the  interrupt  program  at  D800H.  The  inter- 
rupt program  is  contained  in  the  SPOOL  utility  program.  When 
the  user  activates  the  SPOOL  program,  the  intercept  routine 
is  also  loaded  at  D800H. 

The  List  Output  function  is  activated  by  pressing  the 
Control-P  key.  When  the  user  press  the  Control-P  key,  every- 
thing on  the  screen  is  catched  and  loaded  into  E  register 
and  then  sent  to  the  printer.  The  intercept  routine  is 
intended  to  intercept  the  character  in  E  register  and 
provide  the  SPOOL  utility  program  with  that  character.  The 
detail  of  this  mechanism  is  discussed  in  the  next  chapter. 
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Figure  3.2    Entry  Point  of  List  Output  Function, 


27 


IV.  IMPLEMENTATION  OF  THE  SYSTEM 

This  chapter  describes  the  structure  of  the 
Concentrator,  the  connection  between  the  Concentrator  and 
Z-lOO's,  and  the  logic  designs  of  three  processes.  In  the 
last  section  of  the  chapter,  we  address  the  integrated  oper- 
ation of  the  processes. 

A.   STRUCTURE  OF  THE  CONCENTRATOR 

The  structure  of  the  Concentrator  is  shown  in  Figure 
4.1.  The  Concentrator  consists  of  one  iSBC  86/12A  single 
board  computer  and  three  BLC  8538  eight  channel  I/O  expan- 
sion boards.  They  are  connected  to  the  MULTIBUS  so  that  the 
single  board  computer  could  access  any  channel  of  the  three 
expansion  boards.  Since  each  expansion  board  has  eight 
channels,  the  Concentrator  can  have  twenty  four  channels. 
Each  channel  of  the  expansion  board  could  be  connected  to 
one  peripheral  device.  Therefore,  the  Concentrator  can 
control  twenty  four  peripheral  devices.  In  our  design,  the 
printer  is  connected  to  the  Channel  zero,  and  the  other 
twenty  three  channels  are  connected  to  the  TTY  ports  of 
Z-lOO's.  Each  channel  is  associated  with  a  Universal 
Synchronous  Asynchronous  Receiver  Transmitter (USART) ,  which 
contains  four  registers:  Data,  Status,  Mode  1,  Mode  2,  and 
Command  registers.  The  details  about  programming  the  USART 
are  in  the  Chapter  2.  For  more  information  about  the  address 
assignment  of  the  registers,  see  [Ref.  10:  pp.  3.3  -  3.11]. 
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Figure  4.1    Structure  of  the  Concentrator, 


29 


B.  BOOT  PROCESS 

The  function  of  the  BOOT  process  is  to  dov«mload  the 
CONTROL  process  from  any  Z-100  into  the  RAM  of  the  single 
board  computer.  The  logical  flow  of  the  BOOT  process  is 
shown  in  Figure  4.2  and  the  algorithm  of  the  BOOT  process  is 
in  Figure  4.3.  When  the  Concentrator  is  turned  on,  the  BOOT 
process  inside  the  EPROM  of  the  iSBC  86/12A  starts  to  check 
the  status  ports  of  the  multi-channel  expansion  boards  in  a 
round  robin  fashion  to  check  if  a  Z-100  is  turned  on  or  not. 
Since  the  CONSOLE  of  Z-100  is  assigned  to  the  TTY  port,  the 
Z-100  will  send  a  message  terminating  with  'A>'  to  the  dedi- 
cated port  of  the  expansion  board  when  it  is  turned  on.  The 
BOOT  process  will  send  a  command  'TYPE  A: CONTROL. CMD'  to. 
down-load  the  CONTROL  process  when  it  reads  in  the  'A>'. 
Then,  the  Z-lOO  will  send  the  CONTROL.CMD  file  to  the 
Concentrator  while  the  BOOT  process  reads  in  the  file  and 
stores  it  in  the  RAM.  Because  the  TYPE  function  of  the  CP/M 
operating  system  stops  printing  the  file  when  it  meets  a 
Control-Z .character ,  we  have  taken  another  character,  the 
percentage  '%' ,  to  signal  the  end  of  file. 

On  the  completion  of  downloading  the  CONTROL.CMD  file, 
the  CONTROL  process  is  executed.  The  CONTROL  process  issues 
the  reset  command  'STAT  CON:=CRT:',  which  changes  the 
CONSOLE  device  from  TTY  to  CRT.  Then,  'A>'  will  appear  on 
the  screen  of  the  Z-lOO  and  the  user  of  the  Z-lOO  can  do  his 
work.  From  now,  the  CONTROL  process  starts  to  communicate 
with  the  printer  and  the  multiple  Z-lOO  microcomputers.  The 
program  listing  of  the  BOOT  process  is  in  APPENDIX  A. 

C.  CONTROL  PROCESS 

The  function  of  the  CONTROL  process  is  to  control  the 
printer  and  multiple  Z-lOO's  and  to  connect  the  printer  to 
any  one  of  the  multiple  Z-lOO's  at  a  time  so  that  the  data 
could  be  transferred  from  Z-lOO  to  the  printer.  The  purposes 
of  the  CONTROL  process  are: 
1)  To  allow  use  of  the  printer  for  any  connected  Z-IGO. 
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Algorithm  of  BOOT  Program 

*****  Initialization  ***** 

Initialize  the  USARTs 

Set  PORTNO  with  the  first  status  port 

*****  BOOT         Part  ***** 

Repeat 
Read  the  status  port  given  by  PORTNO 
If  the  port  is  Receive-ready 

then  read  a  character  from  the  data  port 
If  the  character  is  '>' 

then  go  to  ISSUECOM  part 
else  store  the  next  status  port  into  PORTNO 

Until  the  control  is  sent  to  the  ISSUECOM 

*****  ISSUECOM    Part  ***** 

Set  the  command  string  with  'TYPE  A:CONTROL.CMD' 

Call  COMMAND 

*****  TRANSFILE  Part  ***** 

Repeat 
Read  a  character  from  the  data  port 
Store  the  character  into  the  new  code  area 

Until  the  character  is  '%' 

Execute  the  CONTROL  program 

*****        Subroutine    COMMAND        ***** 
Send  the  command  string  to  the  Z-100 


Figure    4.3         Algorithm   of   BOOT 
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2)  To  permit  any   Z-100   to  be   activated,  even  during  the 
time  that  the  printer  is  in  use. 

The  logical  flow  of  the  CONTROL  process  is  shown  in  Figure 
4.4  and  the  algorithm  of  the  CONTROL  process  is  in  Figure 
4.5. 

The  CONTROL  process  is  stored  in  CONTROL.CMD  file  of  all 
Z-100' s.  The  CONTROL.CMD  file,  however,  is  downloaded  into 
the  RAM  of  the  single  board  computer  when  the  Concentrator 
and  the  first  of  the  Z-lOO's  is  turned  on.  The  CONTROL 
process  is  composed  of  two  states:  the  control  state  and  the 
transfer  state.  The  CONTROL  process  lies  in  one  of  two 
states  at  a  time.  When  the  CONTROL  process  is  in  the 
control  state,  it  checks  the  status  ports  of  the  multi- 
channel expansion  boards  in  a  round  robin  fashion  to  see  if 
any  boot  or  print  request  is  issued  from  a  Z-100.  If  a 
channel  has  a  request,  the  CONTROL  process  reads  in  the 
character  from  the  data  port  of  the  channel.  The  character 
sequence  'Q'  means  a  print  request  and  'A>'  means  a  boot 
request.  On  receiving  the  character  'Q',  the  CONTROL 
process  sends  a  confirm  character  'Y'  to  the  Z-100  and  then 
goes  to  the  transfer  state.  In  the  transfer  state,  the 
CONTROL  process  receives  a  character  from  Z-lOO  and  sends  it 
to  the  printer  using  a  software  handshaking  method.  The 
CONTROL  process  checks  all  the  other  ports  whenever  one 
hundred  and  twenty  eight  characters  are  sent  to  the  printer 
to  know  if  they  want  to  boot-up.  For  every  port  which  wants 
to  boot-up,  it  issues  the  command  'STAT  CON:=CRT:',  and  then 
continues  to  print  the  characters  in  the  transfer  state. 
After  that,  the  Z-lOO  which  has  received  the  reset  command 
can  work  its  own  job.  The  CONTROL  process  stops  its 
transfer  of  data  between  the  Z-lOO  and  printer  when  it  reads 
in  a  Control-Z  (end-of -f ile)  character,  and  then  enters  the 
control  state  to  check  the  next  status  port. 

When  the  CONTROL  process  reads  in  'A>'  in  the  control 
state,   it  issues   a  reset  command  'STAT   CON:=CRT:'  because 
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Figure  4.4    Logical  Flow  of  CONTROL 
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Algorithm  of  CONTROL  Program 

*****  Initialization  ***** 

Set  PORTNO  with  the  first  status  port 
Call  RESET 

*****  CONTROL     Part  ***** 

Repeat 
Read  the  status  port  given  by  PORTNO 
If  the  port  is  receive-ready 
then  read  a  character  from   the  data  port 
If  the  charater  is  '>' 
then  call  RESET 
else  if  the  character  is  'Q' 
then  go  to  TRANSFER 
else  store  the  next  status  port  into  PORTNO 
Until  the  system  control  is  sent  to  the  TRANSFER 

*****  TRANSFER     Part         ***** 

Repeat 
Read  a  character  from  the  data  port  of  Z-100 
Send  the  character  to  the  printer  port 
Call  BCHECK  on  every  128  characters 

Until  meet  the  End-Of-File  mark  '  ^  Z' 

Go  to  CONTROL 

*****        Subroutine  COMMAND        ***** 
Send  the  command  string  to  the  Z-100 

*****        Subroutine  BCHECK         ***** 
Check  all  other  status  ports  once 
For  each  port  which  has  the  boot-up  request 
call  RESET 


Figure  4.5    Algorithm  of  CONTROL, 
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there  is  no   need  for  downloading  the   CONTROL.CMD  file.   On 
receiving  other   characters  than  'Q'   or  'A>',    the  CONTROL 
process  ignores  them  and  goes  to  the  next  port  to  check. 
Program  listing  of  CONTROL  process  is  in  APPENDIX  B. 

D.   SPOOL  PROCESS 

The  SPOOL  process  has  three  functions.  It  also  has  the 
intercept  routine  for  intercepting  the  List  Output  function 
of  the  BIOS.  The  intercept  routine  is  really  a  part  of  the 
List  Output  function  of  the  BIOS.  The  intercept  routine 
receives  the  control  from  the  List  Output  function  and  calls 
the  SPOOL  program,  and  then  returns  the  control  back  to  the 
List  Output  function  of  the  BIOS.  The  mechanism  between  the 
List  Output  function  and  the  SPOOL  program  is  explained 
below. 

The  SPOOL  process  has  three  options,  they  are: 

1.  Send  the  characters  on  the  screen  of  a  Z-100   directly 
to  the  printer. 

2.  Save  the   characters  on   the  screen  of  a  Z-100  into   a 
disk  file. 

3.  Print  any  existing  disk  file. 

The  logical  flow  of  the  SPOOL  process  is  shown  in  Figure  4.6 
and  the  algorithm  of  the  SPOOL  process  is  in  Figure  4.7. 

The  user  can  select  any  one  of  the  above  options  by 
typing  in  the  appropriate  digit  corresponding  to  the  selec- 
tion. Each  function  is  implemented  with  a  pair  of  modules: 
Set  and  Path.  Function  1  is  composed  of  Setl  and  Pathl, 
Function  2  is  composed  of  Set2  and  Path2 ,  and  Function  3  is 
of  Set3  and  Path3 . 

The  entry  point  on  the  head  of  the  SPOOL  program  is 
composed  of  a  selection  routine  which  jumps  to  one  of  3  Path 
modules  depending  on  the  user's  selection  number. 
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Figure  4.6    Logical  Flow  of  SPOOL 
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1.  Function  1 

Function  1  sends  the  character  on  the  screen 
directly  to  the  printer  through  the  Concentrator  in  Ctrl-P 
mode.  When  the  user  selects  Function  1,  Setl  module  sets 
the  buffer  pointer  with  its  own  buffer  address  and  the  path- 
flag  with  number  one.  Then  the  buffer  pointer  contains  the 
starting  address  of  the  buffer  whose  size  is  128  bytes  and 
the  path- flag  contains  number  one.  On  the  completion  of 
setting  the  buffer  pointer  and  path-flag,  Function  1  comes 
out  to  the  CCP  level,  printing  a  message  that  user  should 
press  the  Ctrl-P  key  and  go  ahead.  As  the  user  hits  Ctrl-P 
key,  the  List  Output  routine  calls  the  address  of  entry 
point  (DOOOH)  of  the  SPOOL  process  whenever  a  character  is 
typed  in.  Since  the  path- flag  is  set  with  number  one,  Pathl 
is  then  activated.  Pathl  reads  in  the  character  in  the 
register  E  which  is  captured  by  the  List  Output  function, 
and  then  sends  the  character  to  the  Concentrator.  The 
Function  1  returns  the  control  back  to  the  List  Output  func- 
tion. Function  1  repeats  this  process  until  the  user  hits 
the  Ctrl-Z  key.  When  the  user  hits  the  Ctrl-Z  key.  Function 
1  comes  out  to  the  CCP  level. 

2.  Function  2 

Function  2  is  similar  to  Function  1  except  that 
Function  2  saves  the  character  in  a  disk  file  while  Function 
1  sends  the  character  to  the  printer  directly.  When  the 
user  selects  Function  2,  Set2  module  sets  the  buffer  pointer 
with  the  buffer  address  and  the  path-flag  with  number  one. 
Set2,  also,  reads  in  user-specified  file  name.  If,  however, 
user  does  not  specify  his/her  own  file  name,  default  file 
name  (TEMPFILE . $$$ )  is  used.  On  the  completion  of  setting 
the  buffer  pointer,  path-flag,  and  reading  in  the  file  name. 
Function  2  comes  out  to  the  CCP  level,  printing  a  message 
that  the  user  should  press  the  Ctrl-P  key  and  go  ahead.  As 
the  user  hits  Ctrl-P  key,  the  List  Output  routine  calls  the 
address  of  entry  point,   which  activates  Path2.   Path2  reads 
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Algorithm  of  SPOOL 

*****  Initialization  ***** 

The  user  selects  one  of  the  three  options 

Go  to  the  corresponding  SET  module 

Each  SET  module  goes  to  the  coresponding  PATH  module 

*****  PATH    1  ***** 

Repeat 

Read  a  character  from  the  Z-100 

Store  the  character  into  the  buffer 

Send  the  character  to  the  printer 
Until  it  meets  the  End-Of-File  mark  ' '  Z' 
Go  to  the  CCP  level 

*****  PATTT    9  ***** 

Call  READNAME 
Repeat 

Read  a  character  from  the  Z-100 

Store  the  character  into  the  buffer 
Until  it  meets  the  End-Of-File  mark  ' '  V 

or  the  buffer  limit 
Make  a  file 
Write  the  file 
Close  the  file 
Go  to  the  CCP  level 

*****  P  A  TT-T    "K  ***** 

Call  READNAME 
Repeat 

Read  a  record  from  the  file 

Send  the  record  to  the  printer 
Until  it  meets  the  End-Of-File  mark  ' '  V 
Go  to  the  CCP  level 

*****     Subroutine  READNAME     ***** 
Read  a  file  name  from  the  console 


Figure   4.7        Algorithm   of    SPOOL 
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in  the  character  in  register  E  which  is  captured  by  the  List 
Output  function,  and  then  store  it  in  the  buffer  while  the 
buffer  pointer  is  incremented.  And  then  Function  2  returns 
the  control  back  to  the  List  Output  function.  Path2  repeats 
this  process  until  the  user  hits  the  Ctrl-Z  key.  Path2 
stores  the  Ctrl-Z  character  on  the  end  of  the  buffer  when  it 
meets  the  Ctrl-Z  character.  After  that,  Path2  makes  a  file 
and  write  the  file  with  the  content  of  buffer  by  one 
record(128  bytes)  at  a  time.  We  use  2  pointers,  the  write 
pointer  and  the  buffer  pointer,  during  writing  the  file. 
Buffer  pointer  points  to  the  address  of  the  last  character 
in  the  buffer  while  write  pointer  is  set  with  the  starting 
address  of  the  buffer.  Whenever  a  record  is  written  in  the 
file,  the  write  pointer  is  increased  by  80H.  Write  process 
is  done  when  the  write  pointer  becomes  greater  than  the 
buffer  pointer.  Since  the  buffer  size  is  not  large  enough 
for  a  big  file,  when  the  buffer  pointer  exceeds  the  limit 
Function  2  will  issue  a  message  that  the  buffer  is  full  and 
the  user  may  take  an  action  to  reset  the  pointers. 

3 .   Function  3 

Function  3  reads  a  file  whose  file  name  is  given  by 
user  and  sends  the  contents  of  file  to  the  printer  through 
the  Concentrator.  Function  3  reads  in  one  record  of  the 
file  at  a  time  and  repeats  this  until  it  meets  the  Ctrl-Z 
character.  The  buffer  is  the  same  one  of  Function  1.  Once 
reading  one  record  into  the  buffer.  Function  3  sends  the 
content  of  buffer  one  byte  at  a  time  to  the  printer  thru 
Concentrator.  Function  3  does  not  need  the  Ctrl-P  function 
while  function  1  and  2  use  it.  Program  listing  of  SPOOL 
process  is  in  APPENDIX  C. 
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V.  CONCLUSIONS 

The  primary  goal  of  this  thesis  was  met.  The  CONTROL 
process  was  designed  for  the  communication  with  the  multiple 
Z-100  microcomputers  and  the  printer,  and  this  is  success- 
fully integrated  into  the  Printer  Multiplexing  System  with 
the  SPOOL  utility  program.  The  BOOT  process  was  designed 
for  downloading  the  CONTROL  process  from  any  one  of  the 
Z-lOO's,  which  eliminated  the  need  for  the  disk  drive, 
console  and/or  additional  EPROM  to  store  the  CONTROL 
process . 

This  system  allows  use  of  the  printer  for  any  connected 
Z-100,  permits  interactive  use  of  the  printer  to  one  user 
when  nobody  else  is  waiting  to  use  it,  and  enables  the 
effective  interactive  sharing  of  the  printer  among  multiple 
users  by  spooling  any  character  on  the  screen  into  a  disk 
file  for  later  batch  printing. 

Future  research  involving  the  Printer  Multiplexing 
System  should  develop  the  8086  code  of  the  SPOOL  utility 
program  so  that  the  users  could  use  the  SPOOL  in  the  envi- 
ronment of  CP/M-86  or  MS-DOS.  The  BOOT  and  CONTROL 
processes  are  already  written  in  the  8086  code. 

Additionally,  we  are  expecting  that  this  system  could  be 
integrated  into  the  Ethernet.  Then  the  CONTROL  process 
should  be  expanded  to  contain  the  Ethernet  protocol  program. 
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APPENDIX  A 
USER  MANUAL  FOR  PRINTER  SHARING 

A.   SYSTEM  CONFIGURATION 

The  Printer  Sharing  system  consists  of  one  iSBC  86/12A 
single  board  computer,  three  BLC  8538  I/O  expansion  boards, 
the  multiple  Z-100  microcomputers,  and  the  printer.  The 
detail  about  the  iSBC  86/12A  single  board  computer  and  the 
BLC  8538  I/O  expansion  boards  can  be  found  in  the  Chapter  2. 


B.  ACTIVATING  THE  SYSTEM 

Turn  on  the  Concentrator  before  any  Z-100  microcomputer 
is  turned  on.  The  user  should  keep  this  power-up  procedure 
because  the  BOOT  program  needs  to  initialize  the  USART 
before  checking  the  ports  of  the  I/O  expansion  boards.  At 
this  time,  the  CONSOLE  device  of  the  Z-100  is  normally 
assigned  to  the  teletype  port.  Otherwise,  the  user  should 
change  the  CONSOLE  device  of  the  Z-100  computer  to  the  tele- 
type port  manually.  And  then,  the  CONTROL.CMD  file  in  drive 
A  is  down- loaded  into  the  RAM  of  the  single  board  computer. 
When  the  CONTROL  program  begins  to  execute,  it  changes  the 
CONSOLE  device  to  the  standard  device  CRT.  Then,  the  Z-100 
user  can  do  his  own  work  on  the  computer. 

C.  USING  THE  SPOOL  PROGRAM 

To  use  the  printer,  the  user  should  type  'SPOOL'  in  the 
CCP  level.  Then  there  appears  a  guidance  about  the  three 
options  of  the  SPOOL  program  on  the  screen.  The  user  can 
select  any  one  of  the  three  options  by  typing  in  the  corre- 
sponding number  of  that  option.  The  three  options  are 
listed  below. 
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1.  Interactive  Print 

When  the  user  selects  option  1,  he  can  use  the 
printer  interactively.  After  the  user  press  the  Ctrl-P  key, 
everything  on  the  screen  is  copied  to  the  printer  through 
the  Concentrator.  This  option  ends  when  the  user  press  the 
Ctrl-Z  key. 

2.  Saving  on  a  Disk  File 

When  the  user  selects  option  2,  he  can  save  the 
characters  on  the  screen  on  the  disk  file.  The  user  is 
asked  to  type  in  the  file  name.  If  the  file  name  is  not 
typed  in,  the  default  file  name  (TEMPFILE. $$$ )  is  used. 
After  the  user  press  the  Ctrl-P  key,  everything  on  the 
screen  is  saved  in  the  buffer.  If  the  buffer  size  exceeds 
the  limit,  a  warning  message  appears  on  the  screen.  In 
this  case,  the  user  should  take  an  action  as  directed  on  the 
screen.  This  option  ends  when  the  user  press  the  Ctrl-Z 
key,  writing  the  buffer  into  the  disk  file. 

3 .  Printing  Existing  Files 

When  the  user  selects  option  3,  he  can  print  any 
existing  file.  The  user  is  asked  to  type  in  the  file  name 
the  user  wants  to  print.  After  a  file  is  printed  out, 
another  file  can  be  printed  continuously  if  the  user  wants 
to  do . 
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APPENDIX  B 
BOOT  PROGRAM 


BOOT   PROGRAM 


Dec  1985.    By  Choi  and  Lee 


;BOOT  program  reads  in  the  status  ports  of  the  I/O  expansion 
;boards  in  a  round  robin  fashion.  If  there  is  a  boot  request 
;on  the  port,  the  BOOT  program  down- loads  the  CONTROL.CMD 
;file  from  the  Z-100  microcomputer.  And  then,  the  BOOT 
;prgram  sends  the  control  to  the  CONTROL  program. 


cseg 
org     0 


INITIALIZATION 


; Initialize  the  USART  and  a  variable  which  contains 
; the  port  number.  On  the  completion  of  initialization,  the 
; control  goes  to  the  BOOT  process. 


mov 

al,Offh 

out 

OaOh,al 

mov 

dh,0 

mov 

dl,82h 

mov 

al,4eh 

44 


call  init 

mov  dl,82h 

mov  a 1,3 eh 

call  init 

mov  dl,83h 

mov  al,07h 

call  init 

mov  portno,85h 

mov  dh,0 


•  St 

» 


BOOT   PART 


;Receives  '>'  character  from  any  one  of  the  multiple  Z-100 
;microcomputers  and  then  downloads  the  CONTROL.CMD  file  to 
; the  memory  of  iSBC  86/12A.  On  the  completion  of  loading  the 
;file,  it  transfers  the  control   to  the   CONTROL  program. 


boot 


mov 

dl ,portno 

in 

al  ,dx 

and 

al,02 

jz 

nextport 

dec 

dx 

in 

al  ,dx 

inc 

dx 

cmp 

al,  '>• 

jnz 

nextport 

jmp 

issuecom 

nextport:  add   dl,4 

cmp    dl,OAOh 


load  DL  reg  with  port  number 

read  the  status  of  the  port 

receive  ready? 

if  not  go  to  next  port 

get  the  data  port 

read  in  the  character  from  Z-100 

get  the  status  port 

compare  the  character  with  '>' 

this  Z-100  is  not  booted  up, 

go  to  nextport 

go  to  ISSUECOM  process 

get  the  next  status  port 
check  if  out  of  range 
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jbe  bypassl 

mov  dl,85h 

bypassl:   mov  portno,dl 

jmp  boot 


if  inside  the  range,  come  along 
the  normal  path 

if  out  of  range, set  DL  reg  with 
the  1st  status  port 

store   addr  of   next  status  port 

in  the  variable. 

repeat  checking  the  status  ports 


ISSUE  COMMAND   PART 


; Issue  the  command  "TYPE  A: CONTROL. CMD"  to  the  Z-100 


issuecom:  mov    si,0 

mov   bx, offset  storage 

call   command 


;set  counter  with  0 
;set  base  reg  with  addr 
;of  command  string 
;send  the  TYPE  command 


TRANSfer   control.cmd   FILE 


;Download  the  control.cmd  file  from  Z-100  to  the  memory  of 
;iSBC  86/12A.  On  the  completion  of  downloading  the  CONTROL 
;file,  the  TRANSFILE  sends  the  control  to  CONTROL  program. 


transf ile :mov 

mov 

next char:  in 
and 


bx, offset  newcode   ;set  base  reg  with   addr 

;of  newcode  area 
si,0  ;set  counter  with  0 


al  ,dx 
al,02 


; read  in  status  port 
; receive  ready? 


46 


jz 

next char 

dec 

dx 

in 

al  ,dx 

cmp 

al,19h 

jnz 

bypass2 

inc 

al 

ass2:   mov 

(bx+si) , 

cmp 

al,'%' 

jz 

adjust 

inc 

si 

inc 

dx 

jmp 

nextchar 

;if  not, read  again 

;get  data  port 

;read  a  char  from  Z-100 

; compare  with  temporary  Ctrl-Z 

;if  not, come  along  normal  path 

;recover  Ctrl-Z  to  lAH 

(bx+si) ,al ; store  char  in  new  code  area 
; compare  with  end  of  file 
; go  to  adjust 
; increase  counter 
;get  status  port 


*  ADJUST  '- 

Reads  in   the   prompt  character   'A>'  from  Z-100,  and   then 
goes  to   the  CONTROL  program. 

;get  the  status  port 
;set  the  counter 

; check  if  receive  ready 


;get  the  data  port 
;read  a  char  from  Z-100 
; get  the  status  port 
;decrease  the  counter 
;if  not  done,  read  again 
newcode  +  132h   ; execute  the  CONTROL  process 


djust : 

inc 

dx 

mov 

cl,4 

tatinl: 

in 

al  ,dx 

and 

al,02 

jz 

statinl 

dec 

dx 

in 

al  ,dx 

inc 

dx 

dec 

cl 

jnz 

statinl 

jmp 

newcode 
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.•..•.  .t..>.Jt..t..><.U.>..V.>..>..^i.^i.U  .•..•>.•.  .•..«..l..«..>..b.>..«..>..>..>..i..^i.^.>....<.>t..V.JU.>..>..>..>..U.i..>..>.>'..>..i..'..l..^..^^ 


subroutine 


Initialization 


.^.^t..'.^.  .«..•..•..•..•«  .^.•..•^.•..•..t..^..<>.V.*..t..<..*..*..^i.>..V.>..>..V.>..>.><..<..<.>VO.  .•>.•..<..•..•..<..•..•.  .•..•..•..•..•..«..>.>^^ 


Initialize  the  USART. 


init : 


out 
add 
cmp 
jbe 
ret 


dx,al  ; write  programming  code  to  USART 

dl,4  ;get  the  next  port 

dljOAOh  ; check  if  out  of  range 

init  ;if  not, write  to  the  next  port 


*  subroutine      COMMAND 

*^      *%      ^%      0\      *%     ¥^     0\      ^\     ^^     ^\      ^%      ^%      ^\      0%     ^\     ^\     0%     ^\      ^%     0%      0%     ¥\      *\      0%      ^^     ^\      ^^     *%      0%     ^^      ^^     *\     *^     ¥\     *\      ^\      ^\      ^%      *%      ^%      ^^     ^^     ^^      ^\     ^% 

Sends  the  command  string  to  the  Z-100 


command: 

in 

aljdx 

and 

al,01 

JZ 

command 

mov 

al ,  (bx+si ) 

dec 

dx 

out 

dx,al 

inc 

dx 

cmp 

al,Odh 

Jz 

eocom 

statin: 

in 

al  ,dx 

and 

al,02 

jz 

statin 

dec 

dx 

in 

al  ,dx 

inc 

dx 

inc 

si 

; check  if  transmit  ready 


;move  a  char  from  command  string 

;get  data  port  of  Z-100 

; send  char  to  Z-100 

;get  status  port 

; compare  char  with  end_of_string 

;if  matches, end  of  command 

; check  if  receive  ready 


;get  data  port  of  Z-100 
;read  a  response  from  Z-100 
;get  status  port 
; increase  counter 


A8 


jmp    command     ; send  another  char 


; check  if  receive  ready 


eocom: 

in 

al,dx 

and 

al,02 

jz 

eocom 

dec 

dx 

in 

al  ,dx 

inc 

dx 

ret 

;get  data  port  of  Z-100 
;read  a  response  from  Z-100 
;get  status  port 


;*  NEW     CODE     AREA 


newcode : 


DATA   STORAGE   AREA 


•  #»  ^*  *^  ^%  '^  ^\  #»  V%  V?  ^%  ^C 


dseg 

org  300h 

storage    db  'type  a: control . cmd' 

db  Odh 

portno    db  0 
end 
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APPENDIX  C 
CONTROL  PROCESS 


CONTROL   PROGRAM 


;*  Dec  1985.    By   Choi   and  Lee  * 

; CONTROL  program  communicates  with  the  printer  and  multiple 
; Z-100  microcomputers.  The  CONTROL  program  resides  in  either 
;the  control  state  and  transfer  state. 


prtdata 
prtstat 


cseg 

equ  80h 

equ  Blh 

org  0 


INITIALIZATION  * 

mov   portno  +  20eh,  85h  ;set  the  port  //  to  85h 
mov    dh,0  ;set  DH  to  0 

call   reset  ;let  the  Z-100  CONSOLE  gain 

; control 
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*  CONTROL    PART  * 

»•*  *•*  «U  *'*  *•*  ••-  *•-.  *•*  »t.  *,•*  «*«  *•*  »•*  •*«  ••-  »•*  *•*  ••*  ♦»,■  ^U  *»*  »r-  *•-  »•-  *•*  .k*«  *'*  *,»*  *•-  *•*  »•*  W*  ••*  *•*  *•-  *•*  *»*  ■!.•*  *•*  *»-  •,»*  *•*  •*-  ••-  ••-  «*«  »»-  •»*  *•-  *•-  »•-  *•-  *•-  *»-  *»-  »•-  *•-  ^'^  *•- 

dl ,portno+20eh  ; load  DL  reg  with  1st  port 
;read  the  status  port 
; check  if  any  request  is  out 
;if  no,  go  to  the  next  port 


;read  the  data  port 

;verify  the  request 
;enter  transfer  state 


;  issue  a  reset  command 

;get  the  next  port 

; check  if  out  of  range 

;if  not, come  along  normal  path 


control: 

mov 

dl ,portn 

in 

al,dx 

and 

al,02 

jz 

nextport 

dec 

dx 

in 

al,dx 

inc 

dx 

cmp 

al,'Q' 

jz 

transfer 

• 

cmp 

al,'>' 

jnz 

nextport 

call 

reset 

nextport : 

add 

dl,4 

cmp 

dl,OaOh 

jbe 

bypassl 

mov 

dl,85h 

bypassl: 

mov 

portno+2 

jmp 

control 

portno+20eh,dl  ; store  the  increased  port  # 


*  TRANSFER   PART 


transfer: 

in 

al  ,dx 

and 

al,01 

Jz 

transfer 

mov 

al,'Y' 

dec 

dx 

out 

dx,al 

; send  "yes"  character  to  Z-100 
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mov    cl,80h     ;set  the  char  counter  with  128 


return: 

inc 

dx 

statinl: 

in 

aljprtstat 

and 

al,01 

jz 

statinl 

statin2: 

in 

aljdx 

and 

al,02 

jz 

statin2 

dec 

dx 

in 

al  ,dx 

inc 

dx 

cmp 

al,19h 

JZ 

eotrans 

out 

prtdata, al 

statin3:   in 

al,dx 

and 

al,01 

jz 

statin3 

dec 

dx 

mov 

al/A' 

out 

dx,al 

dec 

cl 

jnz 

return 

call 

bcheck 

jmp 

return 

read  in  the  data  of  Z-100 

get  the  status  port 

compare  with  Ctrl-Z(IAH).  lAH   is 

temporarily  changed   because  TYPE 

function  stops  printing  at  Ctrl-Z 

if  so,  go  to  end  of  transfer 

send  the  data  to  the  printer 


;send  an  'Acknowledge' 

; decrease  the  char  counter 

; check  all  other  ports  to  know   if 
; there  is  any  boot-up  request 
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^Vf *» ^*%  ***»*»*»  *C5%^^^^^#C^^^#C^*»#*"Vf#* 


J«  «*.  «*«  «•«  «•«  «»«  «K» 


*  END  OF  TRANSFER  * 

End  of  Transfer   sends  the   ending  signal  to  the   Z-100  and 
a  carriage  return  and  a  line  feed  character  to  the  printer. 


eotrans : 


statin4: 


statinS 


in 

and 

jz 

mov 

dec 

out 

in 

and 

jz 

mov 

out 

in 

and 

jz 

mov 
out 
jmp 


al  ,dx 

al,01 

eotrans 

al,'Z' 

dx 

dx,al 


; check  if  Z-100  is  transmit  ready 


; load  AL  reg  with  ending  signal 

;get  data  port 

;send  ending  signal  to  Z-100 


al jprtstat ; check  if  printer  is  ready 

al,01 

statin4 

al,Odh     ;send  a  carriage  return  to  printer 

prtdata,al 

al jprtstat ; check  if  printer  is  ready 

al,01 

statinS 

aljOah     ;send  a  line  feed  to  printer 

prtdata,al 

control 


subroutine 


RESET 


;RESET  subroutine  issues  the  command  'STAT  CON:=CRT:'  to  the 
;  Z-100. 

reset:     mov  si,0 

mov  bx, offset  storage+20eh 

call  command 

ret 
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"  subroutine      COMMAND  * 

••«  •»•-.  «.'«  »•*  **«  «>*«  «'«  *•*  »•*  *•*  «>«  «**  »•*  *•*  *•-  ••*  «*•  ••-  *•-  ■,»*  *•*  »•-  ••*  »•-  »•-  »»*  •.**  »•*  ••*  *•*  ••*  »•-  ••-  ■,•-  »»*  *•*  »•*  »•*  *•*  ••*  *•*  ^^'^  *•*  ••*  *t,  »•-  »»-  »•*  »t .  -  •  -  ^».  - 1  _  _t  -  - 1 _  Jt^  _,!  _  ^t,  ^t^  ^t- 
««#«#%  ^«  #«#«#«««««««#%#«#«#«#»#«««««««  «V  #«  ^«  #«#«#%#«#««*««  ^«  ^«  ««#«#%#«  ^«  ««  ^«  #«  ^«  #»#«  ^«  ««  #V  «%  tf«  ^«  #^  ««««««««#«#%#«  #^  ^«  ^« 

Sends  the  command  string  to  the  Z-100 


command: 

in 

aljdx 

and 

al,01 

jz 

command 

mov 

al, (bx+si) 

dec 

dx 

out 

dx,al 

inc 

dx 

cmp 

al,Odh 

jz 

eocom 

statin6 : 

in 

al  ,dx 

and 

al,02 

jz 

statin6 

dec 

dx 

in 

al,dx 

inc 

dx 

inc 

si 

jmp 

command 

; check  if  transmit  ready 


; move  a  char  from  command  string 

;get  data  port  of  Z-100 

;send  char  to  Z-100 

; get  status  port 

; compart  char  with  end_of_string 

;if  matches, end  of  command 

; check  if  receive  ready 


;get  data  port  of  Z-100 
;read  a  response  from  Z-100 
;get  status  port 
; increase  counter 
;send  another  char 


eocom: 

in 

al  ,dx 

and 

al,02 

jz 

eocom 

dec 

dx 

in 

al  ,dx 

inc 

dx 

ret 

; check  if  receive  ready 


;get  data  port  of  Z-100 
;read  a  response  from  Z-100 
;get  status  port 
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«K.  .*«  «<U  «,•«  «•*  »•«  «.'«  «*«  «•«  «•«  «•«  «V  «•«  «U  •*.  «<U  «*«  «*«  *•«  «,*«  «•«  «*«  «•«  .kt«  «t«  «.!«  «t^  ^t«  .««  ^t«  ^t«  «t«  ^f^  ^t^  «f «  jt^  «,#,  «t,  «f *  «f «  «*•  «i^  .•«  «*«  «•«  «*«  .'«  «*«  «'«  «*«  •*«  «'«  «V  «*«  *.' «  .*«  «*«  «•«  «.*« 

*  subroutine  BOOTCHECK  -' 

Checks  all  the  other  status  ports  to  know  if  there  is  a 
boot-up  request  from  the  Z-100.  For  each  port  which  has 
a  boot-up  request , issues  a  reset  command. 


b check: 

inc 

dx 

mov 

ch,dl 

mov 

dl,85h 

ncheck: 

cmp 

dl,ch 

jnz 

bypass3 

add 

dl,4 

bypass3 : 

cmp 

dl,OaOh 

ja 

eocheck 

in 

al,dx 

and 

al,02 

jz 

nextportl 

dec 

dx 

in 

al  ,dx 

inc 

dx 

cmp 

al,'>' 

jnz 

nextportl 

call 

reset 

nextport 1 

:add 

dl,4 

jmp 

ncheck 

eocheck: 

mov 

dl,ch 

• 

dec 

dx;port 

mov 

cl,80h 

ret 

;get  the  current  status  port 
; store  it  in  CH  register 
; starts  from  the  first  port 

; check  if  the  port  is  itself 


; check  if  out  of  range 
;if  yes, end  of  checking 

;read  the  status  port 

; check  if  any  request  is  out 

; if  no,  go  to  the  next  port 

;read  the  data  port 


; let  Z-100  console  gain  control 

;get  the  next  port 

; check  if  out  of  range 

;recover  the  current  status 
; reset  the  char  counter 
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«,*«  »'*  *•*  ••*  »•*  *'-  »•-  ■.•*  *^  »•-  ••-  »•»  ••-  *•-  ••-  ••-  ••*  »'*  •'-  •^»  *.'-  •••  »•->  ••-  »•-  *•-  ••-  *•-  ••-•  •■•*  »•-•  »•-  »»-  ••-  •'*  »•-  ••-  •.'-  »•-  «.•-  *»»  V-  *A.  *•-  »•-  *•-  *•*  »•*  »'-  •.'-  ••-  ••*  *•-  *•*  *•*  *•-  •.♦-  •••-  *•* 


DATA   STORAGE   AREA 


dseg 
org  100 

portno     db  0 

storage   db  'stat  con:=crt:' 

db  Odh 

db  '%' 

db  lah 
end 
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APPENDIX  D 
SPOOL  PROCESS 


«,*«  «*«  «*«  lA.  *•*  tJU  *.%m  •f^  ••*  «*«  all*  «<U  ••*  •**  »•*  *•*  *,*«  «,'«  «'«  W>«  ••*  »•*  *•-  .A*  ••*  •.**  »•*  «*«  »•*  »,•*  ••-  *•*  *f»  »•*  *•*  »•*  *,•-  ••-  ••-  ••-  ••-  .,*«  .t.  •,•*  «•«  «*«  *<U  *•*  •»-  ••-  *.•-  ••-  ••-  »•-  *•-  *»-  »•-  ••-  JU 

;*  ,         SPOOL   PROGRAM  * 


i 


* 


Dec  1985.   By   Choi   and  Lee 


; SPOOL  program  has  three  options : print  interactively,  save 
;the  char  into  a  disk  file,  and  print  any  existing  file.  It 
;also  contains  the  intercept  routine  for  intercepting  the 
; char  in  the  E  register  in  the  Ctrl-P  mode. 


* 

;*  DECLARATION   PART 


conin 

equ 

1 

; console  input  char 

printf 

equ 

9 

; print  string 

readconf 

equ 

10 

;read  console  buffer 

openf 

equ 

15 

;open  file 

closef 

equ 

16 

;close  file 

readf 

equ 

20 

;read  file 

writef 

equ 

21 

;write  file 

makef 

equ 

22 

;make  file 

setdmaf 

equ 

26 

;set  DMA  address 
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eof        equ    lah 
ttystat    equ    0e9h 
ttydata    equ    OeSh 


end_of_file  character 
TTY   status  port 
TTY   data   port 


boot 

equ 

OOOOh 

bdos 

equ 

0005h 

fcb 

equ 

005ch 

dbuff 

equ 

0080h 

wrptr 

equ 

607ch 

pointer 

equ 

607eh 

tdma 

equ 

6080h 

;warm  boot  entry 

;bdos  entry 

;default  file  control  block 

•jdefault  DMA  address 

;write  buffer  pointer 

; temporary  DMA  buffer  pointer 

; temporary  DMA  buffer  address 


INITIALIZATION 


org    lOOh 
call   init 


org    OdOOOh 


entry 


; entry  point  of  SPOOL  process 

read  the  user's  choice 

if  option  1 

then, go  to  pathl 

if  option  2 

then, go  to  path2 

jmp  to  communication  error 


Ida 

pathfl 

cpi 

1 

jz 

pathl 

cpi 

2 

jz 

path2 

jmp 

comerror 
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module    PATH  1 


; Catch   a   character   from  E  register   and   store  it  in  the 
;buffer,  and  then  send  the  character  to  the  concentrator 


pathl: 


leap: 


push 

a!   push  b! 

Ihld 

pointer 

mov 

m,e 

call 

sendchar 

inx 

h 

mov 

a,l 

ani 

Offh 

jnz 

leap 

Ixi 

h, tdma 

shld  pointer 
pop  h!   pop  d! 
ret 


push  d!   push  h! 
load  HL  reg  with  next  buffer  ptr 
move  input  char  to  the  buffer 
send  char  to  concentrator 
increase  buffer  ptr 
check  if  buffer  ptr  reached   end 
of  buffer 

if  not, go  along  the  normal  path 
if  end  of  buffer, reset  buffer  ptr 

; store  the  increased  buffer  ptr 
pop  b!   pop  a! 


module   PATH  2 


;Catch  a  character  from  E  register  and  store  it  into  the 
;buffer.  When  the  end_of_f ile (Ctrl-Z )  character  is  met,  make 
;a  file  and  write  the  buffer  into  the  file 

pathZ:     push  a!   push  b!   push  d!   push  h! 

Ihld   pointer    ; load  HL  reg   with  next  buffer  ptr 

;move  input  char  to  the  buffer 


mov 
mov 
cpi 
jz 


m,  e 
a ,  e 

save 


; compare  with  end_of_file  mark 
;if  it  matches , write  the  buffer 


59 


mark: 


markl 


cpi 

~ 

jnz 

mark 

Ida 

warn 

cpi 

1 

jz 

warning 

inx 

h 

mov 

a,h 

cpi 

OcOh 

jnz 

markl 

mvi 

a,l 

sta 

warnf 1 

; increase  buffer  pointer 


shld   pointer    ; store  increased  buffer  pointer 

pop  h!   pop  d!   pop  b!   pop  a! 

ret 


5  ** 


module   PATH  3 


;Read  the  file  whose  file  name  is  given  by  the  user  into  the 
;buffer  by  one  record(128  bytes)  at  a  time.  And  then  send 
;the  characters  of  the  buffer  to  the  concentrator. 

path3 :     call  open  ;open  the  file 

Ixi  d,nofile 

inr  a  ;if  it  fails  to  open  the  file 

cz  finis  ; go  to  finish  with  error  message 


copy: 


call  read      ; read  a  record  from  file  into  buff 

ora  a         ;if  it  meets  end_of_file  char 

jnz  eotranf   ;go  to  end  of  transfer  file 

call  filesend  ;send  record  to  printer  thru  concen 
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jmp 

copy 

eotranf : 

Ixi 

d, normal 

finis : 

call 

trnsrdy 

mvi 

a,  eof 

out 

ttydata 

call 

rcvrdy 

in 

ttydata 

mvi 

c  jprintf 

call 

bdos 

load  the  address  of  normal  message 

check  if  transmit  ready 

load  Ace  with  end_of_file  char 

send  it  to  concen 

check  if  receive  ready 

read  a  response  from  concen 

print  the  normal  message 


call   morefile  ;handle  a  request  of  another  print 
jmp    boot      ; come  out  to  CCP  level 


subroutine   SENDCHARACTER 


•^  ••*  •,'*  ••*  »•*  ••*  *•*  •'-  ••-  ••-  ••-  ••-  »»* 


;Send  a  character  of  the  buffer  to  the  concentrator 

sendchar : 

check  if  transmit  ready 

move  char  from  E  to  Ace 

compare  with  '  '  of  Ctrl-Z 

if  yes, then  go  to  end  of  send 

if  not  Ctrl-Z, send  the  char 

check  if  receive  ready 

receive  an  acknowledgement  char 


call 

trnsrdy 

mov 

a,e 

cpi 

»  1 

jz 

eosend 

out 

ttydata 

call 

rcvrdy 

in 

ttydata 

ret 
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*•-  »•*  »•*  »<•  »»*  »»-  *•*  »•-  ••*  *•*  »•-  -.•-•  *»-  •'*  *•*  *•-  *t*  *t.  *•-  •.»-  »•*  »•-  •»•-  ••-  *•*  »*•  ••-  »'-  »•-  ••-  ••-  »•-  *•-  *•-  ••-  ••-  *•-  ••-  ••-.  •'-  *•-  »•-  •.'-  *.*-  ••-  »•-»  *•- 


*  <l.*^  ••-  <k*«  »•-  ••*  *»*  * 


SAVE 


h»-  »•*  •♦*  »•-  ••*  *•-  *v  *•-  *•-  »•-  «*««*««•«  *•-  *•*  *•*  «*«  *'««.'«  *•-  »•-  •»*  »•- 


.  .•.  .•.  .•.  .•.  .•.  .•.  .•.  .<.  .•.  .*.  .t.  .*.  .<.  .•.  .•. .«.  .•<  .•.  ji, .'.  .•< .«,  .•.  .•.  .*.  .•. .«.  .<.  .•.  «•. 


save 


call   diskcopy 
call   epcopy 


subroutine   DISKCOPY 


;Write  the  content  of  the  buffer  onto  the  disk  file 

diskcopy:  Ihld  pointer 

mvi  a,eof 

mov  m , a 

call  make 


dmachg:    call   setdma 
call   write 


;make  a  file 

;set  DMA  address 

;write  the  DMA  buffer  onto  the  file 


;Increase  the  write  pointer  by  80h  and  restore  it 

load  HL  reg  with  write  ptr 

move  the  lower  addr  of  write  ptr 

add  80h  to  it  with  carry 

load  L  with  increased  lower  addr 

if  no  carry, jmp  to  leapl 

if  carry  is  out, 

add  1  to  upper  addr  of  write  ptr 

load  H  with  increased  upper  addr 


Ihld 

wrptr 

mov 

a,l 

aci 

80h 

mov 

l,a 

jnc 

leapl 

mov 

a,h 

adi 

1 

mov 

h,a 

leapl: 


shld  wrptr 


;restore  the  increased  write  ptr 
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; Compare  the  write  pointer  with  the  buffer  pointer 

load  HL  reg  with  buffer  ptr 
move  HL  reg  to  DE  reg 
load  HL  reg  with  write  ptr 
move  upper  addr  of  buffer  ptr 
subtract  write  ptr  from  buffer  ptr 
if  result  is  minus, go  to  eocopy 
if  result  is  plus, write  more 
move  lower  addr  of  buffer  ptr 
subtract  write  ptr  from  buffer  ptr 
if  result  is  plus, write  more 


Ihld 

pointer 

xchg 

Ihld 

wrptr 

mov 

a,d 

sbb 

h 

cm 

eocopy 

JP 

dmachg 

mov 

a,e 

sbb 

1 

JP 

dmachg 

ret 

subroutine   FILESEND 


;This  subroutine  sends  the  characters  of  the  DMA  buffer  to 
;the  concentrator.  This  subroutine  returns  the  control  back 
;to  the  PATH3  when  it  meets  the  Ctrl-Z  (end  of  file  char) 
;or  the  end  of  buffer. 


f ilesend: 

mvi 

c,128 

Ixi 

d,dbuff 

nextchar : 

Idax 

d 

inx 

d 

mov 

b,a 

call 

trnsrdy 

mov 

a,b 

cpi 

eof 

jz 

eotranf 

;set  the  buffer  counter 

;set  DE  register  with  buffer  addr 

; load  Ace  with  a  char  from  buffer 
;increase  buffer  ptr 
;move  the  char  of  A  into  B 

; check  if  transmit  ready 

;get  stored  char 

; compare  the  char  with  end_of_file 

; if  yes, then  go  to  end  of  transfer 
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out  ttydata  ; send  the  char  to  concen. 

call  rcvrdy  ; check  if  receive  ready 

in  ttydata  ; receive  an  ack  char  from  Z-100 

dcr  c  ;decrease  buffer  ptr 

jnz  next char  ;if  not  zero, get  the  next  char 

ret 


subroutine   END  OF  SENDCHAR 


eosend:    call  trnsrdy  ; check  if  transmit  ready 

mvi  a,eof  ;yes,send  an  end_of_file  char 

out  ttydata 

call  rcvrdy  ; check  if  receive  ready 

in  ttydata  ; receive  an  ack  char  from  concen. 

jmp  boot  ; come  out  to  CCP 


subroutine   END  OF  COPY 


eocopy:    call  close 

mvi  Cjprintf 

Ixi  d,eosave 

call  bdos 

jmp  boot 
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JUiJU.t.  .*..«..«. 

subroutine 

WARNING 

warning : 

mvi 

a,0 

sta 

OecOdh 

mvi 

Cjprintf 

Ixi 

djwarnmsg 

call 

bdos 

call 

diskcopy 

call 

eocopy 

ret 

subroutine   MAKE 


make:      mvi  c,makef 

Ixi  d,tfcb 

call  bdos 
ret 


subroutine   OPEN 


open:      mvi  c,openf 

Ixi  d,tfcb 

call  bdos 
ret 


subroutine   READ 


read:      mvi  c,readf 

Ixi  djtfcb 

call  bdos 
ret 
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subroutine   CLOSE 


close:     mvi  c,closef 

Ixi  d,tfcb 

call  bdos 
ret 


.'-  ••-  ••-  .1-  .•-  .1-  .•-  .«,  .•,  «•,  «•.  .».  .V  .«- 


subroutine   WRITE 


write:     mvi  c,writef 

Ixi  djtfcb 

call  bdos 
ret 


subroutine   SETDMA 


setdma:    mvi    c,setdmaf 
Ihld  wrptr 
xchg 

call   bdos 
ret 


subroutine   TRANSMIT  READY 


trnsrdy:   in  ttystat 

ani  01 

jz  trnsrdy 
ret 


subroutine   RECEIVE   READY 


^ ..»,.. «.  .y  ^  „  ,^  .^  ^  ^  n ,.  n 


rcvrdy:    in  ttystat 

ani  02 

j  z  rcvrdy 
ret 
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subroutine    INITIALIZATION 


; Select  an  option  of  three  alternatives 

init : 

mvi  c,printf   ;print  the  query  string 

Ixi  d, query 

call  bdos 

mvi  CjConin    ;read  the  answer  of  user 

call  bdos 

cpi  '1' 

cz  setl       ;print  out  directly  in  Ctrl-P  mode 

cpi  '2' 

cz  set2       ;save  on  a  file  in  Ctrl-P  mode 

cpi  3 

cz  set3       ;print  any  existing  file 

call  ty"perror   ;  typing  error 

ret 


-  module   SET  1  * 

Set  the  buffer  pointer  and  path-flag.   Also   checks  if   the 
printer  is  busy  or  not. 

setl:      Ixi  h,tdma  ;load  HL  reg  with  addr  of  buffer 

shld  pointer  ; store  buffer  addr  into  buffer  ptr 

mvi  a,l  ;set  pathflag  with  number  1 

sta  pathfl 

call   trnsrdy    ; check  if  transmit  ready 
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mvi    a.,'Q*      ;send  a  request  to  concen. 
out    ttydata 

mvi    CjOffh     ;set  counter  with  #  of  trials 

;read  status  port 

; decrease  the  counter 

;if  zero, should  wait 


; receive  an  ack  from  concen. 
;print  a  starting  message 


call   bdos 

jmp    boot       ;come  out  to  CCP 


statinl: 

in 

ttystat 

dcr 

c 

cz 

waite 

ani 

02 

jz 

statinl 

in 

ttydata 

mvi 

Cjprintf 

Ixi 

d, start 

module    SET  2 


;Set  the  buffer  pointer  and  write  pointer.     Also  construct 
;the  FCB  whose  file  name  is  given  by  the  user. 

set2:      Ixi  h,tdma     ;set  the  buffer  and  write  ptr  with 

shld  pointer    ; the  buffer  address 

shld  wrptr 

mvi  a, 2        ;set  the  pathflag  with  number  2 

sta  pathfl 

mvi  Cjprintf   ;print  the  selection  message 

Ixi  djSelname  ;load  DE  reg  with  addr  of  msg 

call  bdos 

call  readname   ;read  file  name  given  by  the  user 

mvi  Cjprintf   ;print  the  starting  message 
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Ixi   d, start 
call   bdos 
jmp   boot 


module   SET  3 


; Construct  the  FCB  whose  file  name  is  given  by  the  user,  and 
; check  if  the  printer  is  busy  or  not. 


set3 


mvi    c,printf   ;print  file  name  message 

Ixi    d,selname  ; load  DE  reg  with  addr  of  message 

call   bdos 


call  readname 

call  trnsrdy 

mvi  a , ' Q ' 

out  ttydata 

mvi  c,Offh 


statinZ:   in 

ttystat 

dcr 

c 

jz 

waite 

ani 

02 

jz 

statin2 

in 

ttydata 

cpi 

'Y' 

jnz 

comerror 

jmp 

pathB 

;read  the  filename  typed  by 
;into  FCB 

; check  if  transmit  ready 

;send  a  request  to  concen. 

;set  counter  with  #  of  trials 

read  status  port 
decrease  the  counter 
if  zero, printer  is  busy 
check  if  receive  ready 
if  not  ready, read  again 
read  response  from  concen. 
is  response  'Yes'? 
if  not , communication  error 
starts  to  send  the  file 


user 
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Subroutine 


MORE 


FILE 


*  »**  *»-  *»*  »•-  »•*  •>*«  mA*  «<«  •k<«  JU  •<«  «,'«  •.■«  «*«  •* *  JU  »*«  ^"^  mf^  ••-  ••«  «^«  •,!•  «,*« 


moref ile 

I 

mvi 

c,33 

Ixi 

d, af cb 

Ixi 

h,tfcb 

movaf cb : 

Idax 

d 

mov 

m,  a 

inx 

d 

inx 

h 

dcr 

c 

jnz 

movaf cb 

mvi 

c  jprintf 

Ixi 

d,moreprt 

call 

bdos 

mvi 

c , conin 

call 

bdos 

cpi 

'Y' 

cz 

set3 

cpi 

'N' 

cnz 

typerror 

ret 

;set  counter  with  #  of  char  of  AFCB 
; load  DE  reg  with  addr  of  AFCB 
;load  HL  reg  with  addr  of  TFCB 

; load  Ace  with  char  of  AFCB 

; store  char  of  Ace  into  TFCB 

;increasd  addr  of  AFCB 

; increase  addr  of  TFCB 

;decrease  counter 

; if  not  done,  move  the  nest  char 

;print  the  message 


;read  the  answer  of  user 

;if  yes, print  anotherfile 

;if  no , come  out  to  CCP 

;if  any  other  char,  error  message 


Subroutine   TYPERROR 


typerror: 


mvi  c,printf  ;print  error  message 

Ixi  djtyperrm 

call  bdos 

jmp  boot 
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Subroutine    COMmunication  ERROR 


comerror : 


mvi  a,'P*     ;tell    the    concentrator   of 

; communication  error 

out  ttydata 

mvi  Cjprintf  ;print  error  message  on  the  screen 

Ixi  d,comerrm 

call  bdos 

jmp  boot 


Subroutine    WAITE 


waite 


mvi 


a,'P 


tell  the  concen.  of  communication 


; error 
out    ttydata 

mvi    c,printf  ;print  the  wait  message 
Ixi    djwait 
call   bdos 
jmp    boot 


*•-  ••*  *•-  *•-  *^*  *•*  *.»,  •»*  *•*  »•*  »•*  ••*  »••  ••* 


Subroutine 


READNAME 


readname 


mvi    c,readconf    ;read  the  edited  file  name 
Ixi    d, filename    ; given  by  user 
call   bdos 


Ixi  d,filename+l 

Idax  d 

cpi  0 

jz  default 


load  DE  addr  of  char  counter 
load  Ace  the  i/^   of  chars 
if  file  name  is  not  typed, 
then  take  the  default  filename 
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mov 

c,a 

inx 

d 

Ixi 

h,tfcb+l 

mvi 

b,8 

readfnr: 

Idax 

d 

cpi 

f  t 

jz 

readf t 

call 

charconv 

mov 

m,  a 

inx 

d 

inx 

h 

dcr 

c 

jz 

eoread 

dcr 

b 

jz 

meetdel 

jmp 

readfnr 

;inove  the  #  of  chars  to  C  reg 
;load  DE  reg  with  the  address  of 
;name  buffer 
; load  HL  reg  with  the  addr  of  TFCB 

;set  the  #  of  chars  of  the  filename 


;move  the  filename  to  TFCB 
;if  it  meets  the  delimiter, 
;then  read  filetype 
; convert  the  lower  case  into 
;upper  case  character 


;no  filetype,  go  to  end_of_read 
;if  #  of  filename  exceeds  8 
;then,  go  to  meet_delimiter 
;read  the  next  char  of  filename 


meetdel : 

Idax 

d 

cpi 

»  » 

jz 

readf t 

inx 

d 

jmp 

meetdel 

;read  a  char  from  console  buffer 
; compare  with  the  delimitter 
; if  matches, read  file  type 
; increase  name  buffer  pointer 
; repeat  reading  char 


readf t : 


mvi 
inx 
dcr 
Ixi 


b,3 

d 

c 

h,tfcb+9 


set  char  counter  with  3 
increase  name  buffer  pointer 
decrease  #  of  chars 
load  HL  with  addr  of  file  type 
of  File  Control  Block 
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readftr: 

Idax 

d 

call 

charconv 

mov 

m,a 

dcr 

c 

jz 

eoread 

dcr 

b 

jz 

eoread 

inx 

d 

inx 

h 

jmp 

readftr 

eoread: 

ret 


read  a  char  from  name  buffer 
convert  lower  case  into  upper 
store  char  into  FCB 
decrease  //  of  chars 
if  name  buffer  exhausted 
then, go  to  end  of  read 
decrease  file  type  counter 
if  FCB  is  full, go  to  eoread 
increase  name  buffer  pointer 
increase  FCB  pointer 


.•.^..•..•..t..< '. 


,  c"""^^        Subroutine   DEFAULT 

;copy  the  default  FCB  into  Temporary  FCB. 


default 


mvi  c,33  ;set  the  counter  with  33 
Ixi  d,dfcb  ;set  Default  FCB  pointer 
Ixi    h,tfcb    ;set  Temporary  FCB  pointer 


movf cb : 

Idax 

d 

mov 

m,  a 

inx 

d 

inx 

h 

dcr 

c 

jnz 

movf cb 

ret 

;read  a  char  from  DFCB 
; store  it  into  TFCB 
•.increase  DFCB  pointer 
; increase  TFCB  pointer 
;decrease  counter 
; move  another  char 
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Subroutine   CHARCONVert 
Converts  the  characters  from  'a'  through  'z'  into  the  upper 
case  characters. 


charconv: 

cpi 

•a' 

jm 

nochange 

cpi 

'z' 

JP 

nochange 

sui 

20h 

nochange : 

ret 

DATA 


AREA 


pathfl: 

db 

0 

warn: 

db 

0 

dfcb: 

db 

0 

db 

'TEMPFILE' 

db 

'$$$' 

db 

0,0,0,0 

ds 

16 

db 

0 

ds 

3 

tfcb: 

db 

0 

db 

f         f 

db 

?    1 

db 

0,0,0,0 

ds 

16 

db 

0 
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ds  3 

af cb :    db  0 
db 
db 

db  0,0,0,0 

ds  16 

db  0 

ds  3 

filename : 

db  16 

ds  16 


query:   db  Odh,Oah 

db       'Welcome  to  SPOOL  utility.  ' , Odh, Oah, Odh, Oah 
db       'Three  options  are:  ', Odh, Oah 

db  '1.  Print  any  characters  on  console  directly' 

db  'to  the  printer.' 

db  Odh, Oah 

db  '2.  Save  any  charecters  on  console  in  a  file.' 

db  Odh, Oah 

db  'Print  any  existing  f ile . ' , Odh, Oah 

db  Odh, Oah, Odh, Oah 

db  'Select  any  one  of  three  options  above  :  $' 

start:   db  Odh, Oah 

db  'Press  the  Control_p  key  and  go  ahead.' 

db  Odh, Oah 

db  'On  the  completion  of  your  work,  press  the' 

db  '  Control_Z  key' 

db  Odh,Oah,'$' 

selname:db  Odh, Oah, ' File  name  :  $' 
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moreprt : db 
db 

typerrm: db 
db 

eoprint :db 

eosave:  db 

wait:  db 
db 

comerrm: db 
db 

nofile:  db 

wrprot :  db 

normal:  db 

warnmsg: db 
db 
ds 

stack: 


Odh,Oah,'Do  you  like  to  print  another  file?' 
'(Y/N)  :  $' 

Odh,Oah 

'Typing  error.  Try  again. $' ,Odh, Oah, '$ ' 


Odh,Oah 

Odh,Oah 

Odh,Oah 
Odh,Oah 

Odh,Oah 
Odh,Oah 

Odh,Oah 

Odh,Oah 

Odh,Oah 

Odh,Oah 
Odh,Oah 
32 


Printing  complete. ' ,0dh,0ah, '$ ' 
Saving  file  complete .', Odh, Oah 
Printer  is  busy  now.  Try  again. ' 

Protocol  error.  Try  again. ' 

$' 

No  source  f ile . ' , Odh,Oah, ' $ ' 

Write  protected?' , Odh, Oah, '$' 

Spool  complete. ', Odh, Oah, '$' 

Your  file  is  out  of  buffer  size' 
Make  your  file  again' , Odh, Oah, ' $ 


Intercept  Routine  of  Control-p 


org 

OdSOOh 

call 

OdOOOh 

mvi 

a,19h 

jmp 

Of99ch 

end 
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